Summary

• Rewrite README.md to be concise and action-oriented: quick uv install, local run instructions, and building/using the standalone executable.
• Add Development.md with detailed contributor guidance: managing deps with uv/Poetry, PyInstaller spec usage with hiddenimports vs datas, local build and testing tips, and linting commands.

Why
The previous README accumulated unorganized agent notes across sessions. This change presents a clean, minimal Quickstart, and moves deeper developer content into a dedicated Development.md.

Changes

• README.md:
  • Add Quickstart with uv install
  • Steps to run the CLI locally (make install-dev, make run)
  • Clear binary build and usage section (build.sh --install-pyinstaller, dist/ outputs)
  • Reference to Development.md for advanced details
• Development.md:
  • How to add runtime and dev dependencies (uv and Poetry)
  • Spec file guidance including when to use hiddenimports vs datas
  • Build workflows (scripted and manual) and how to test the executable
  • Lint/format commands and credentials note

Testing

• Ran make lint; all hooks passed (ruff, mypy, pyproject validation, etc.)
• No application code changes; existing tests unaffected

Docs

• README.md fully refreshed
• New Development.md added

Linked issues

• Closes Clean agent comments from main readme #19

Notes

• No PR template found in this repo; followed standard sections.

@malhotra5 can click here to continue refining the PR